Skip to content

SPE: document container type owner billing management - #11016

Open
Gregory Joseph (gnjoseph) wants to merge 3 commits into
SharePoint:mainfrom
gnjoseph:agents/featureauthzen-review-page-update
Open

SPE: document container type owner billing management#11016
Gregory Joseph (gnjoseph) wants to merge 3 commits into
SharePoint:mainfrom
gnjoseph:agents/featureauthzen-review-page-update

Conversation

@gnjoseph

@gnjoseph Gregory Joseph (gnjoseph) commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Category

  • Content fix
  • New article

Related issues

  • None

What's in this Pull Request?

This PR documents standard-billing self-service for SharePoint Embedded container type owners and aligns billing-role guidance across the SharePoint Embedded documentation.

  • Directs container type owners to the SharePoint Embedded Visual Studio Code extension or Model Context Protocol (MCP) server for standard-billing management.
  • Documents Attach billing in the Visual Studio Code extension and the MCP server's billing_setup and billing_check tools as the supported owner facilities.
  • Clarifies that non-administrator owners can manage standard billing only for container types they own.
  • Clarifies that SharePoint Embedded Administrators and Global Administrators can manage any standard-billed container type in the developer tenant.
  • Documents Billing Administrator or Global Administrator for consuming-tenant pass-through billing setup in the Microsoft 365 admin center.
  • Clarifies that the SharePoint Embedded Administrator role alone doesn't grant access to that Microsoft 365 billing procedure.
  • Preserves User org and user organization billing as names for the pass-through model.
  • Links the Azure Owner and Contributor role definitions where those roles are required.
  • Aligns developer, ISV, customer-setup, troubleshooting, and admin guidance across 12 existing articles.

The change intentionally doesn't add a dated What's new entry. Release timing remains separate from the documentation draft.

Validation

  • SPE style, technical-accuracy, and implementation reviewers reviewed the original 12-article correction and the focused five-article review-feedback update.
  • The SPE fix-suggester refined the billing-role draft. Focused implementation review and final style and accuracy repasses for the abstraction update returned no findings.
  • A full DocFX build completed successfully with zero warnings or errors for the target articles. Existing unrelated repository warnings remain.
  • git diff --check passes.
  • Existing ms.date and other selected metadata values are unchanged from main.
  • Relative Markdown links, heading anchors, VS Code and MCP workflow links, and Azure Owner and Contributor links were validated.
  • The public content contains no raw billing resource payload, internal permission names, app IDs, rollout controls, internal links, or test-tenant details.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit ed7166e:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/admin/setup-billing-microsoft-365-admin-center.md ✅Succeeded View
docs/embedded/build/create-container-type.md ✅Succeeded View
docs/embedded/plan/choose-billing-model.md ✅Succeeded View
docs/embedded/publish/choose-app-billing-model.md ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Greg Joseph and others added 2 commits August 31, 2026 13:29
Add the Azure Resource Manager flow for owner-scoped standard billing and clarify the separate administrator and pass-through billing boundaries.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Restore Billing Administrator support for consuming-tenant pass-through billing and clarify the separate container type owner, SharePoint Embedded Administrator, and Global Administrator scopes. Add Azure RBAC role links and keep product terminology consistent.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@gnjoseph
Gregory Joseph (gnjoseph) force-pushed the agents/featureauthzen-review-page-update branch from ed7166e to 8499680 Compare August 31, 2026 20:31
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents self-service standard billing and aligns billing-role guidance across SharePoint Embedded documentation.

Changes:

  • Adds an Azure CLI workflow for container type owners.
  • Clarifies standard and pass-through billing permissions.
  • Aligns customer setup, administration, and troubleshooting guidance.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/embedded/reference/troubleshooting.md Updates pass-through billing roles.
docs/embedded/publish/validate-customer-installation.md Separates setup and billing responsibilities.
docs/embedded/publish/customer-tenant-setup-guide.md Clarifies customer roles and prerequisites.
docs/embedded/publish/choose-app-billing-model.md Documents billing ownership and permissions.
docs/embedded/plan/container-types-containers.md Updates pass-through billing roles.
docs/embedded/plan/choose-billing-model.md Adds owner self-service billing instructions.
docs/embedded/build/create-container-type.md Aligns container type billing guidance.
docs/embedded/admin/setup-billing-microsoft-365-admin-center.md Clarifies consuming-tenant billing setup.
docs/embedded/admin/install-sharepoint-embedded-app.md Updates installation billing roles.
docs/embedded/admin/create-apps-sharepoint-admin-center.md Clarifies owner billing permissions.
docs/embedded/admin/consuming-tenant-admin.md Updates pass-through billing requirements.
docs/embedded/admin/admin-overview.md Adds Billing Administrator responsibilities.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/embedded/admin/create-apps-sharepoint-admin-center.md Outdated
Comment thread docs/embedded/build/create-container-type.md Outdated
Comment thread docs/embedded/build/create-container-type.md Outdated
Comment thread docs/embedded/build/create-container-type.md Outdated
Comment thread docs/embedded/plan/choose-billing-model.md Outdated
Comment thread docs/embedded/publish/choose-app-billing-model.md Outdated
Replace raw Azure Resource Manager and Azure CLI guidance with the SharePoint Embedded Visual Studio Code extension and MCP server workflows requested in review. Preserve owner-scoped and administrator billing boundaries.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@andrewconnell Andrew Connell (andrewconnell) added pr:in-review Actively reviewing pull request pr:awaiting-peer-reviews Awaiting the requested reviewers to complete their review. and removed pr:in-review Actively reviewing pull request labels Sep 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr:awaiting-peer-reviews Awaiting the requested reviewers to complete their review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants